package com.nageoffer.shortlink.project.toolkit;

import cn.hutool.core.lang.hash.MurmurHash;

/**
 * HASH 工具类
 * 基于 MurmurHash 算法‌ 和 Base62 编码‌ 的哈希工具类，主要用于将字符串转换为短哈希值

 * 技术要点：
 *      MurmurHash‌：高性能非加密哈希算法，适合分布式场景
 *      Base62 编码‌：相比 Base64，去除了易混淆字符（如 +、/），适合生成短链或唯一标识
 *      负数处理‌：确保哈希值始终为正，避免转换异常

 * 典型应用场景‌：
 *     短链接生成‌：将长 URL 哈希为短字符串（如 short.ly/abc123）
 *     唯一键生成‌：为数据生成紧凑的唯一标识
 */
public class HashUtil {

    // CHARS 数组：包含 0-9、A-Z、a-z 共 62 个字符，用于 Base62 编码
    private static final char[] CHARS = new char[]{
            '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
            'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
            'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z'
    };

    // SIZE：固定为 CHARS.length（即 62），表示编码的进制基数
    private static final int SIZE = CHARS.length;

    /**
     * 将十进制数 num 转换为 Base62 字符串
     */
    private static String convertDecToBase62(long num) {
        StringBuilder sb = new StringBuilder();
        while (num > 0) {
            int i = (int) (num % SIZE);
            sb.append(CHARS[i]);
            num /= SIZE;
        }
        return sb.reverse().toString();
    }

    /**
     * 对输入字符串 str 进行哈希并转换为 Base62 编码
     */
    public static String hashToBase62(String str) {
        int i = MurmurHash.hash32(str);
        long num = i < 0 ? Integer.MAX_VALUE - (long) i : i;
        return convertDecToBase62(num);
    }
}
